home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / zcommdoc.zip / ZCOMMDOC.AC < prev    next >
Text File  |  1993-05-30  |  69KB  |  1,771 lines
  1.  
  2.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                   61
  4.  
  5.       good robustness in many applications.
  6.  
  7.       True YMODEM transfers one or more files in a batch, without alteration
  8.       or added garbage characters.  True YMODEM also preserves the file date
  9.       across multiple time zones.  ZCOMM and the Unix(TM) rb and sb programs
  10.       preserve the file modification date.[3]
  11.  
  12.  
  13.       13.7.2  YMODEM-1k  The sb k option (1024 byte blocks) may be used to
  14.       enhance throughput, especially when using timesharing systems,
  15.       satellite links, or packet networks that can support the longer
  16.       blocks.
  17.  
  18.  
  19.       EXAMPLE: sb -k *.c *.h sends all .c and .h files in the current
  20.       directory with 1024 byte blocks.[4]
  21.  
  22.       YMODEM and YMODEM-1k transfers can be received with the rb or F3
  23.       commands.
  24.  
  25.       YMODEM file transfers with Unix and VMS systems are discussed later in
  26.       this chapter.
  27.  
  28.       Some programs claim to support YMODEM but actually use XMODEM with
  29.       1024 byte blocks.  These programs do not meet the YMODEM Minimum
  30.       Requirements defined by the YMODEM protocol.
  31.  
  32.       One can use ZCOMM's XMODEM sx -k and rc commands with these
  33.       traditional programs.
  34.  
  35.       13.7.3  YMODEM with OverThruster  YMODEM and YMODEM-1k file
  36.       downloading from networks and timesharing systems is slowed by
  37.       response times.  This slowing may be significant even when 1k blocks
  38.       are used.  With some systems, one can speed up YMODEM downloads by
  39.       using the o option with the rb command to receive the file.  Because
  40.       OverThruster(TM) defeats error recovery, a line hit will usually abort
  41.       a download.  OverThruster(TM) may be used with X.PC or MNP error
  42.       correcting link level protocols.
  43.  
  44.       EXAMPLE: rb -o
  45.  
  46.  
  47.  
  48.  
  49.       __________
  50.  
  51.        3. Controlled by the d and z numeric parameters
  52.  
  53.        4. ZCOMM switches to 128 byte blocks at the end of a file when the
  54.           length warrants.
  55.  
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  59.  
  60.  
  61.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                   62
  63.  
  64.       SEE ALSO: O numeric parameter
  65.  
  66.       13.7.4  XMODEM-1k  The XMODEM-1k protocol transfers one file per
  67.       command with 1024 byte blocks and a nominal 16 bit CRC.  The file name
  68.       must be entered for both the sender and the receiver.  Programs
  69.       lacking ZCOMM's Cybernetic Data Recovery(TM) logic are less likely to
  70.       transfer data accurately under marginal conditions.  XMODEM's use of
  71.       every possible 8 bit code causes problems in some applications.
  72.  
  73.       The end of the file may be padded by up to 127 or 1023[5] garbage
  74.       characters.
  75.  
  76.       To send a file with XMODEM-1k: sx -k file1
  77.  
  78.       To receive a file with XMODEM-1k: rc file1
  79.  
  80.       13.7.5  XMODEM-CRC (with fallback)  The XMODEM-CRC protocol transfers
  81.       one file per command.  The XMODEM-CRC protocol requires the receiving
  82.       program to initiate an XMODEM-CRC transfer.
  83.  
  84.       The file name must be entered for both the sender and the receiver.
  85.       Even with CRC-16, programs lacking ZCOMM's Cybernetic Data
  86.       Recovery(TM) are less likely to transfer data under marginal
  87.       conditions.  XMODEM-CRC's use of every possible 8 bit code causes
  88.       problems in some applications.
  89.  
  90.       The end of the file may be padded by up to 127 garbage characters.
  91.  
  92.       To send a file with XMODEM (or XMODEM-CRC): sx file1
  93.  
  94.       To receive a file with XMODEM-CRC: rc file1
  95.  
  96.       13.7.6  Classic XMODEM  The original MODEM protocol, developed by Ward
  97.       Christensen, is supported by a large and growing number of programs
  98.       operating on a variety of micros and minis.  The base level XMODEM
  99.       protocol gives good results when used over low error rate direct
  100.       telephone connections.  XMODEM's short data blocks and use of every
  101.       possible 8 bit code preclude its application in many environments.
  102.  
  103.       File transfers with this protocol add up to 127 garbage characters to
  104.       transferred files.  The XMODEM protocol can transfer one file per
  105.       command.  The file name must be entered at both the sender and the
  106.       receiver.
  107.  
  108.       To send a file with XMODEM: sx file1
  109.  
  110.  
  111.       __________
  112.  
  113.        5. Some programs (including ZCOMM) limit this padding to 127 bytes.
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  118.  
  119.  
  120.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                   63
  122.  
  123.       To receive a file with Classic XMODEM: rx file1
  124.  
  125.       13.7.7  Relaxed XMODEM  ZCOMM's XMODEM and YMODEM support has been
  126.       optimized for maximum reliability with a wide variety of systems under
  127.       a wide variety of conditions.
  128.  
  129.       The default XMODEM and YMODEM timeout parameterss are "relaxed"
  130.       timings.  They rarely need to be lengthened except under the most
  131.       sluggish of conditions.  The zmodem t, T, and p numeric parameters
  132.       (q.v.) control timeouts for XMODEM, YMODEM, and ZMODEM.  The default
  133.       values allow 10 seconds for a packet to appear and a 10 second pause
  134.       within a packet before starting error recovery.
  135.  
  136.       EXAMPLE: zmodem pt200 pp150  :: Set more relaxed X/Y/ZMODEM timing
  137.  
  138.  
  139.       For best reliability, Omen Technology does not recommend tightening
  140.       these timings for XMODEM and YMODEM transfers on noisy lines.
  141.  
  142.       13.7.8  XMODEM with OverThruster  XMODEM file downloading from
  143.       networks and timesharing systems is slowed by short blocks and long
  144.       response times.  With some systems, one can speed up downloads by
  145.       using the ro command to receive the file.  Because OverThruster(TM)
  146.       defeats error recovery, a line hit will usually abort a download.
  147.       With nearly error free connections, one can save enough time from the
  148.       increased throughput to make up for the failed transfers.
  149.       OverThruster(TM) may be used with X.PC or MNP error correcting link
  150.       level protocols.
  151.  
  152.       EXAMPLE: ro file1
  153.  
  154.  
  155.       EXAMPLE: rb -o
  156.  
  157.  
  158.       SEE ALSO: O numeric parameter
  159.  
  160.       13.7.9  YMODEM-g: Traditional Overdrive  The proliferation of error
  161.       correcting modems has sparked a proliferation of YMODEM-g programs,
  162.       more and more of which actually meet minimal YMODEM protocol
  163.       specifications.
  164.  
  165.       YMODEM-g transmits 0 or more files per batch with an ACK-less variant
  166.       of YMODEM-1k.  The sender does not wait for individual data blocks to
  167.       be acknowledged, allowing high speed transfers with error correcting
  168.       modems.
  169.  
  170.       YMODEM-g assumes an error free communications channel.  A single
  171.       transmission error or character lost because of DOS or TSR interrupt
  172.       latency ruins the entire transfer, and YMODEM-g does not support Crash
  173.       Recovery(TM).
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  177.  
  178.  
  179.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                   64
  181.  
  182.       ZCOMM supports True YMODEM-g with the sb and rb -g commands.
  183.  
  184.       EXAMPLE: sb *.old Sends files in the current directory with YMODEM or
  185.       YMODEM-g protocol.  The receiver controls whether YMODEM or YMODEM-g
  186.       is used for the transfer.
  187.  
  188.  
  189.       EXAMPLE: rb -g Receives with YMODEM-g protocol.
  190.  
  191.  
  192.       13.7.10  XMODEM Mutants Misrepresented as YMODEM  Despite continuing
  193.       education efforts, a few lazy software providers insist on identifying
  194.       their mutant XMODEM protocols as "ymodem".  They choose to ignore the
  195.       definition of YMODEM that Ward Christensen wrote when he coined the
  196.       term YMODEM in his April 1985 message:
  197.  
  198.          (a) a record 0 containing filename date time and size
  199.          (b) a 1K block size option
  200.          (c) CRC-16.
  201.  
  202.       Use the XMODEM sx-k and rc commands to deal with these nonstandard
  203.       programs.
  204.  
  205.       In case of questions, please refer to ymodem.doc, part of yzmodem.zoo
  206.       for for the official YMODEM protocol.  (Available in Omen's ZMODEM
  207.       Developer's Collection.)
  208.  
  209.       13.7.11  Qmodem-G/Streaming XMODEM  The Qmodem program and certain
  210.       bulletin boards provide an ACKless XMODEM mutant protocol selected
  211.       with the Qmodem G protocol menu choice.
  212.  
  213.       The sx and rx -g commands support this mutant XMODEM.
  214.  
  215.       EXAMPLE: rx -g qmodem.fil
  216.  
  217.  
  218.       13.7.12  WXMODEM (People-Link)  ZCOMM supports WXMODEM protocol
  219.       downloads with the rw command.  On the People-Link timesharing
  220.       service, WXMODEM downloads are faster than XMODEM downloads.
  221.       Throughput, reliability, accuracy, and amenities are not as good as
  222.       ZMODEM or SuperKermit, but neither of these protocols are currently
  223.       available on that system.  WXMODEM adds up to 127 garbage bytes to
  224.       transferred files.  Omen Technology does not recommend WXMODEM for use
  225.       over noisy phone lines.
  226.  
  227.       EXAMPLE: rw file1
  228.  
  229.  
  230.       13.7.13  MODEM7 Batch  The MODEM7 batch protocol passes CP/M file
  231.       names from the sending program to the receiver one character at a
  232.       time.  The compatibility, throughput, and reliability problems of this
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  236.  
  237.  
  238.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                   65
  240.  
  241.       kluge prompted the development of YMODEM.  Nonetheless, when it
  242.       becomes necessary to transfer files with a program lacking more
  243.       advanced protocols, MODEM7 batch is better than nothing.
  244.  
  245.       File names transmitted with the MODEM7 batch protocol must obey the
  246.       restrictions of both 8 bit CP/M and DOS.  The f option cannot be used
  247.       with MODEM7 batch.  Data transfer within MODEM7 batch uses XMODEM
  248.       protocol, and all of XMODEM's weaknesses discussed above apply to
  249.       MODEM7 batch.  MODEM7 batch does not preserve the modification date or
  250.       exact file contents.
  251.  
  252.       EXAMPLE: s7 file1.ext *.baz sends files with MODEM7 batch.
  253.  
  254.  
  255.       EXAMPLE: r7 receives one or more files with MODEM7 batch.
  256.  
  257.  
  258.       13.7.14  Telink/FIDO  The Telink protocol expands upon the MODEM7
  259.       batch kluge with a specially formatted block containing the length of
  260.       the file and the local DOS time and date.  All of the MODEM7 batch
  261.       compatibility and reliability problems apply to Telink.[6] The zmodem
  262.       Z numeric parameter or the z file transfer option may be used to
  263.       correct the time/date stamping of files transferred between different
  264.       time zones.
  265.  
  266.       EXAMPLE: zmodem pZ120;  st file1.ext *.baz Sends the specified files
  267.       with a 2 hour time zone adjustment.
  268.  
  269.  
  270.       EXAMPLE: rt -z60 Receives one or more files with a 60 minute time zone
  271.       adjustment.
  272.  
  273.  
  274.       13.7.15  SEAlink  When transferring files with the CLINK 1.13
  275.       compatible programs, ZCOMM's rb and sb commands recognize SEAlink's
  276.       modified Telink protocol.  The rb command allows a transmitting
  277.       SEAlink program to use sliding windows.  Telink time zone and file
  278.       name considerations apply to SEAlink.  In addition, because SEAlink
  279.       uses all 256 of the possible 8 bit codes for both data transfer and
  280.       protocol management, some modems and networks that operate with XMODEM
  281.       will not accommodate SEAlink.  As with the MODEM7 and Clink protocols
  282.       mentioned above, the SEAlink protocol is included for convenience in
  283.       situations where the YMODEM and ZMODEM protocols are not
  284.  
  285.  
  286.       __________
  287.  
  288.        6. ZCOMM's rt and st commands were verified with Minitel 3.0 by Tom
  289.           Jenning's Fido Software; other Programs may not produce the same
  290.           results.
  291.  
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  295.  
  296.  
  297.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                   66
  299.  
  300.       implemented.[7]
  301.  
  302.       EXAMPLE: zmodem pZ120;  sb file1.ext *.baz Sends the specified files
  303.       to a SEAlink program with a 2 hour time zone adjustment.
  304.  
  305.  
  306.       EXAMPLE: rb -z60 Receives one or more files from a SEAlink program
  307.       with a 60 minute time zone adjustment.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.       __________
  345.  
  346.        7. ZCOMM's SEAlink was verified with CLINK 1.13 by Systems
  347.           Enhancement Associates.  Other Programs may not produce the same
  348.           results because of ambiguities in the SEAlink documentation and
  349.           undocumented protocol variants.
  350.  
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  354.  
  355.  
  356.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                   67
  358.  
  359.       13.8  Kermit
  360.  
  361.       13.8.1  ZCOMM Kermit Capabilities At a Glance
  362.        Local operation..................Yes
  363.        Remote operation.................Yes
  364.        Transfers text files.............Yes
  365.        Transfers binary files...........Yes
  366.        Wildcard send....................Yes
  367.        Filename collision avoidance.....Yes
  368.        Can time out.....................Yes
  369.        8th-bit prefixing................Yes
  370.        8 bit serial data................Yes
  371.        Sliding Windows..................Yes
  372.        Long Packets.....................Yes
  373.        Repeat count prefixing...........Yes
  374.        Alternate block checks...........Yes
  375.        Terminal emulation...............Multiple
  376.        Communication settings...........Yes
  377.        Transmit BREAK...................Yes
  378.        IBM mainframe communication......Yes
  379.        Transaction logging..............Yes
  380.        Act as server....................no
  381.        Talk to server...................Yes
  382.        Advanced commands for servers....Yes
  383.        Handle file attributes...........no
  384.        Programmable reset string........Yes
  385.  
  386.       Kermit operates with a wide range of computer systems, including those
  387.       whose restrictive terminal interfaces prevent XMODEM transfers.
  388.       Kermit uses an encoding technique called quoting to represent control
  389.       characters and (if necessary) parity bits with standard printable
  390.       characters.  It is one of the few asynchronous error correcting
  391.       protocols that work properly with half duplex IBM front ends.  Because
  392.       of the overhead from character quoting, Kermit is less efficient
  393.       (slower) than ZMODEM.
  394.  
  395.       Kermit can transfer one or more files per command, preserving the
  396.       exact file length.
  397.  
  398.  
  399.       EXAMPLE: kermit sb file1 file2
  400.  
  401.  
  402.       EXAMPLE: kermit rb
  403.  
  404.  
  405.       13.8.2  Incompatible Kermit Dialects  When sending files with the
  406.       Kermit Protocol, ZCOMM uses all 8 bits for the transfer unless a 7 bit
  407.       parity mode (e.g., ena -7e) is used, the kermit 7 numeric parameter is
  408.       non zero, or the other program requests 8th bit qouting.  If ZCOMM is
  409.       using a 7 bit parity mode (such as ena -7m), ZCOMM requests 8th bit
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  413.  
  414.  
  415.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                   68
  417.  
  418.       quoting unless the kermit 8 numeric parameter is non zero.
  419.  
  420.       -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  421.                       Both programs must use the same parity
  422.                       for Kermit file transfers to succeed.
  423.       -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  424.  
  425.       Kermit does not provide an automatic means of forcing both the sender
  426.       and receiver to use the same dialect.  Files cannot be transferred if
  427.       the two programs disagree on parity handling, Such failures are quite
  428.       commonplace.  A common symptom is a transfer that starts up normally
  429.       but always fails at the same block.  Setting appropriate parity
  430.       corrects these Kermit failures.
  431.  
  432.       ZCOMM's Kermit AutoDownload(TM) (enabled with the K term option)
  433.       allows the term function to sense the beginning of a Kermit file
  434.       download, make the proper determination on whether to use 8 bit serial
  435.       data, and execute the file download without user intervention.
  436.  
  437.  
  438.       13.8.3  Kermit Performance Enhancements  ZCOMM features Long Packet
  439.       Kermit for increased throughput with suitable systems, including many
  440.       that do not support sliding windows.  ZCOMM allows Kermit long packets
  441.       up to 1000 characters on DOS, up to 2048 on 32 bit Unix systems.
  442.  
  443.       ZCOMM also supports Kermit with Sliding Windows.  "Super-Kermit"
  444.       transmits multiple packets before waiting for a response, increasing
  445.       throughput with timesharing systems and networks.
  446.  
  447.       The maximum send packet length is set by the kermit l numeric
  448.       parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  449.       less.
  450.  
  451.       EXAMPLE: k pl94
  452.  
  453.  
  454.       The maximum receive packet length is set by the kermit L numeric
  455.       parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  456.       less.
  457.  
  458.       EXAMPLE: k pL94
  459.  
  460.  
  461.       With the default values for the kermit l and kermit L parameters,
  462.       ZCOMM will choose long packets over sliding windows when a choice is
  463.       possible.
  464.  
  465.       ZCOMM supports 12 bit Kermit checksums and 16 bit Kermit CRC for
  466.       professional error detection performance.  ZCOMM uses the most
  467.       reliable Kermit error correction available.  Shorter checksums may be
  468.       forced by changing the kermit b numeric parameter.
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  472.  
  473.  
  474.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                   69
  476.  
  477.       13.8.4  Accessing Kermit Servers  The commands to start up a Kermit
  478.       server vary from system to system.  Unix C-Kermit can be started in
  479.       server mode with kermit -ix given to Unix or VMS.  When the Kermit
  480.       server is active, the ZCOMM get, send, and remote ...  commands may be
  481.       used.  The ZCOMM finish command causes the remote Kermit server to
  482.       exit to its operating system.
  483.  
  484.       13.8.5  Kermit Caveats  Some versions of Kermit translate files as
  485.       they are sent, by default!  Typical modifications include CR/LF to NL
  486.       transformations and CPMEOF stripping.  Before transferring binary
  487.       files, such editing must be disabled with SET FILE TYPE BINARY or
  488.       similar commands given to the other program.  The demonstration in
  489.       Chapter 10 includes several Kermit server access and file transfer
  490.       commands.
  491.  
  492.       If the Kermit protocol doesn't work with IBM mainframe communications,
  493.       incorrect ASCII/EBCDIC translate tables may be the problem.
  494.  
  495.       Some mainframe "front ends" require special characters or a break
  496.       signal to recover from transmission errors ("line hits").  The
  497.       kermreset string parameter (q.v.) may be programmed with the required
  498.       sequence.
  499.  
  500.       SEE ALSO: kermreset string parameter
  501.  
  502.       When downloading files from some versions of Kermit, best results may
  503.       sometimes be obtained by starting ZCOMM's kermit receive before typing
  504.       the carriage return that starts the sender on the remote.  If the
  505.       other program includes an adjustable initial delay, you can save time
  506.       by setting it to zero.
  507.  
  508.       SEE ALSO: kermit d numeric parameter
  509.  
  510.       SEE ALSO: K term option (Kermit AutoDownload(TM))
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  531.  
  532.  
  533.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                   70
  535.  
  536.  
  537.  
  538.       13.9  Transferring Files with Unix Systems
  539.  
  540.       13.9.1  Terminal Servers / Port Multiplexers  Some Unix systems are
  541.       accessed via a port multiplexer or other network.  Some of these
  542.       interfere with data transmission.  In some cases it has been necessary
  543.       to contact the manufacturer to obtain undocumented instructions or
  544.       software updates to make the multiplexers or networks suitable for
  545.       file transfers.
  546.  
  547.       These systems may require additional control characters to be escaped.
  548.       The sz command e option may be used to escape all control characters.
  549.  
  550.       SEE ALSO: e option
  551.  
  552.       Individual control characters can be escaped with the zmtxesc string
  553.       parameter.
  554.  
  555.       SEE ALSO: zmtxesc string parameter
  556.  
  557.       Sometimes it is necessary to use 7-bit transfers with the E or EP
  558.       options.
  559.  
  560.       EXAMPLE: sz -EP bigkahuna.zip
  561.  
  562.  
  563.       13.9.2  Uploading Files to Unix Systems  Files may be sent to Unix
  564.       systems conveniently and quickly with ZMODEM.  Unix flavors of
  565.       Professional-YAM support the full ZMODEM-90(TM) feature set including
  566.       Intelligent Crash Recovery(TM) and selective transfers with the rz
  567.       command, a hard link to the /usr/bin/yam program.
  568.  
  569.       If the Unix system is operating with 7 bits, the sender's zmodem d
  570.       parameter may have to be increased to allow the rz program time to
  571.       change Unix to 8 bits for the transfer.
  572.  
  573.       SEE ALSO: zmodem d numeric parameter
  574.  
  575.       Traditional Unix systems limit serial input buffering to a few hundred
  576.       characters or less.  This is sometimes too small to prevent data loss
  577.       and retransmissons when operating at high speeds.  On SCO Unix 3.2.4
  578.       this bufering can be increased by increasing the TTYHOG and NCLIST
  579.       kernel parameters.
  580.  
  581.       13.9.3  The rz and sz Programs  Professional-YAM is the fastest Unix
  582.       ZMODEM upload program.  Pro-YAM uses a minimum of CPU resources for
  583.       uploads.  Pro-YAM provides the best ZMODEM technology and feature set
  584.       available., but it may not be available on a particular system.  The
  585.       rz program, part of the rzsz package, may be used to support a subset
  586.       of Pro-YAM's ZMODEM features.
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  590.  
  591.  
  592.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                   71
  594.  
  595.       If rz is not installed on the target Unix system, unpack the rzsz.zoo
  596.       file on your MSDOS system with: booz x rzsz.zoo given from the DOS
  597.       prompt.[8] Next, the command source zupl.t calls the zupl.t script to
  598.       upload the bootstrap file minirb.c, compile it, and use it to upload
  599.       the remainder of the source files.  After the rest of the files have
  600.       been uploaded, compile rz.c and sz.c using the directions given in the
  601.       README file and in the C source files.
  602.  
  603.       The rz and sz manual pages may be formatted with a make doc command.
  604.  
  605.       The undos program may be used to remove carriage returns in files
  606.       uploaded to Unix machines.
  607.  
  608.       13.9.4  Downloading Files from Unix Systems  To download files from
  609.       Unix(TM) systems, use the Unix sz command to send the desired files to
  610.       ZCOMM.  To Unix keyboard: sz file ...  ZCOMM's ZMODEM AutoDownload(TM)
  611.       takes care of the rest for you, saving unnecessary keystrokes.
  612.  
  613.       If one or more of the files already exists on the destination disk,
  614.       use sz -y file ...  instead, to replace the old copies on your
  615.       computer.
  616.  
  617.       Another useful option sends only the files that exist on both
  618.       computers (Y), and furthermore sends only those that are newer (n):
  619.       sz -Yn file ...
  620.  
  621.       When files are long and transmission slow, you can save time by
  622.       compressing them first.  The zoo program, available for DOS and Unix,
  623.       may be used to compress file(s) before transmission.
  624.  
  625.       Omen Technology products support ZMODEM compression with the Z option.
  626.       All Omen Technology products support compression by Run Length
  627.       Encoding (RLE).  Unix flavors of Professional-YAM also support LZW
  628.       compression.
  629.  
  630.       Unix source files normally do not contain carriage returns used by
  631.       CP/M and DOS.  Some CP/M or DOS programs, such as C compilers, do not
  632.       require carriage returns in the source files.  Others, such as the
  633.       Microsoft Macro Assembler, become quite confused by such files,
  634.       although such files fully meet the requirements of the ASCII standard.
  635.  
  636.       Carriage Returns may be added before downloading with the todos or
  637.       tocpm programs.  Carriage returns may be added during the transfer
  638.  
  639.  
  640.       __________
  641.  
  642.        8. On Unix systems with Professional-YAM installed, the rzsz source
  643.           files and man pages are installed in the /usr/src/command/rzsz
  644.           directory.
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  649.  
  650.  
  651.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                   72
  653.  
  654.       with the sz a option.  Carriage Returns may be added after the
  655.       transfer by some program editors, including uEMACS.  (Other editors,
  656.       such as DOS edlin may crash trying to edit such files.) Short files
  657.       (less than 64kb) may be converted using ZCOMM's read and create
  658.       commands to pass the data through ZCOMM's capture buffer.
  659.  
  660.       Text files may also be downloaded using the capture buffer if sz has
  661.       not been installed on the Unix machine.
  662.  
  663.       If a file or set of files are to be transported between two Unix
  664.       systems, it may be helpful to place them in a tar or cpio archive (and
  665.       possibly compress the archive) before transmission.  This procedure
  666.       will preserve the Unix file modes and modification times, and bypass
  667.       pathname restrictions imposed by DOS.
  668.  
  669.       As with rz, Unix Professional-YAM is linked to sz to support the full
  670.       ZMODEM-90(TM) feature set.  Otherwise the separate Unix sz program may
  671.       be obtained as described in the previous subchapter.
  672.  
  673.       13.10  VAX/VMS File Transfers
  674.  
  675.       Most of the comments made above about Unix file transfers apply to VMS
  676.       as well.  Many VAX/VMS systems attach terminals with terminal
  677.       multiplexers just as nasty as those used with Unix systems.  They
  678.       require fixes similar to those described above for Unix systems..
  679.  
  680.       Automatic uploads to VMS may require setting the zmodem d (delay)
  681.       numeric parameter to give time for the VMS rz program to properly
  682.       initialize.
  683.  
  684.       SEE ALSO: zmodem d numeric parameter
  685.  
  686.       EXAMPLE: zmodem pd15
  687.  
  688.  
  689.       13.10.1  Version 4 rz/sz  Omen provides VMS flavors of version 4 rz
  690.       and sz precompiled in rzsz.tlb, a VMS "text library".  Version 4 rz
  691.       supports most ZMODEM-90 features including Crash Recovery,
  692.       compression, and MobyTurbo.  Binary uploads write files with a default
  693.       VMS 512 byte fixed length record format.
  694.  
  695.       EXAMPLE: sz biglib.tlb
  696.  
  697.  
  698.       Sending to VMS with the i option selects the VMS Stream_LF record
  699.       format.  Stream_LF preserves the exact file length and data contents
  700.       when read by C programs.
  701.  
  702.       EXAMPLE: sz -i vmsemacs.exe
  703.  
  704.  
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  708.  
  709.  
  710.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                   73
  712.  
  713.       Sending to VMS with the I option causes the VMS receiver to use
  714.       variable length binary records.  VMS Kermit-32 and some other programs
  715.       understand this record format.
  716.  
  717.       Text files uploaded with the a option are written in variable length
  718.       records with CR carriage control.
  719.  
  720.       EXAMPLE: sz -a emacs*.c
  721.  
  722.  
  723.       Version 4 VMS sz supports standard VMS wild card and directory
  724.       recursion syntax.
  725.  
  726.       EXAMPLE: $ sz -qa [*...]*.prn sends all accessible .prn files on the
  727.       system in ASCII mode. The VMS sz q option suppresses the initial tally
  728.       of the number of files and their lengths.  This tally can take some
  729.       time when a large number of files and directories are invloved.  The f
  730.       option may be added to send directory names as well.
  731.  
  732.  
  733.       If you use Kermit to upload the rzsz.tlb file to VMS, command the
  734.       receiving Kermit program to SET FILE TYPE FIXED.  (Some VMS Kermit
  735.       programs may require SET FILE TYPE BLOCK.) Otherwise Kermit will
  736.       garble the data.
  737.  
  738.       13.11  GEnie File Transfers
  739.  
  740.       The General Electric Consumer Information Service service (GEnie) uses
  741.       ZMODEM-90(TM) for efficient downloads.  GEnie's ZMODEM server selects
  742.       ZMODEM RLE Compression or MobyTurbo(TM) for optimum download speed on
  743.       each file.
  744.  
  745.       GEnie uses a large network to provide callers with local access
  746.       numbers.  This requires technical tradeoffs to control data flow in
  747.       the network.  If you are using an MNP modem, download speeds can be
  748.       improved by increasing GEnie's ZMODEM window size.
  749.  
  750.       EXAMPLE: genie24   speed 4800 249-8365/mnp set adlopts "W16384"
  751.  
  752.  
  753.       Startup on Genie ZMODEM AutoDownloads can be speeded up by disabling
  754.       Security Verification.
  755.  
  756.       EXAMPLE:      ena -yZ   :: Disable ZMODEM Security verification
  757.  
  758.  
  759.  
  760.       The sx file.exe command is used for XMODEM-CRC uploads to GEnie.  When
  761.       uploading with XMODEM-CRC, Wait for GEnie's "READY FOR INPUT, start
  762.       your XMODEM upload." message, and then wait for the XMODEM-CRC C to
  763.       appear before issuing the sx command.  Issuing the sx command before
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  767.  
  768.  
  769.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                   74
  771.  
  772.       the C appears may corrupt the uploaded file.
  773.  
  774.       A number of GEnie access scripts are provided in scripts.zoo with
  775.       filenames starting with ge.  The main GEnie login script is provided
  776.       in phones2.t witin scripts.zoo.
  777.  
  778.       13.12  BIX File Transfers
  779.  
  780.       BIX (Byte Information Exchange) supports ZMODEM-90 and Kermit file
  781.       transfers.
  782.  
  783.       The Tymnet phone number in the bix telephone directory entry should be
  784.       changed for your calling area.  Other scripts are provided to handle
  785.       BIX mail and conferences.
  786.  
  787.       When setting up a new BIX account, give the command call bix,new to
  788.       force a login to the BIX new account program.
  789.  
  790.       Be sure to select ZMODEM downloads and uploads with the BIX "OPTIONS"
  791.       menu choice.  Set the Zcomm adlopts string variable to  m or mr to
  792.       enable MobyTurbo and ZMODEM Crash Recovery.
  793.  
  794.       When uploading over Tymnet or other networks, it may be necessary to
  795.       set the zmodem w numeric parameter to a value between 2048 and 8192
  796.       for best upload performance.  The optimum value depends on load and
  797.       the particular node you dial in to.
  798.  
  799.       EXAMPLE: z pw6144
  800.  
  801.  
  802.       BIX's transfer time predictions are about 40 per cent too pessimistic
  803.       for ZMODEM transfers.
  804.  
  805.       A number of BIX scripts are included in SCRIPTS.ZOO.
  806.  
  807.       13.13  CompuServe File Transfers
  808.  
  809.       B+ Protocol is used by the CompuServe Timesharing Service through the
  810.       CompuServe, Tymnet, and Telenet networks.  B+ Protocol file transfers
  811.       are initiated by the CompuServe computer.  The B+ Protocol file
  812.       transfer protocol is well supported by this timesharing service.
  813.       Under typical conditions, the B+ Protocol saves 35 per cent or more in
  814.       file transmission time and connect charges compared to XMODEM protocol
  815.       transfers.
  816.  
  817.       The c or C term option must be set with ena -c or ena -C to allow the
  818.       B+ protocol to seize control and transfer files.
  819.  
  820.       The adlopts string parameter allows the y and v file transfer options
  821.       to be specified for B+ protocol transfers.
  822.  
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  826.  
  827.  
  828.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                   75
  830.  
  831.       The w numeric parameter controls the block length used by the
  832.       CompuServe B+ Protocol.  A longer length increases throughput, but may
  833.       overload some networks, resulting in excessive retransmissions or
  834.       failed transfers.  The maximum B+ block length is 1024 data bytes.  A
  835.       value of 0 (the default) allows the Compuserve computer to control the
  836.       block length.  A negative value controls the upload block length but
  837.       still allows Compuserve to control the download block length.  Uploads
  838.       to Compuserve using longer block lengths are sensitive to poor flow
  839.       control, especially when error correcting modems (MNP, etc.) are used.
  840.       If B+ uploads fail or require excessive retransmissions, correct the
  841.       flow control arrangements, disable the modem's error correction, or
  842.       try a smaller upload block size.
  843.  
  844.       The data contents of successfully transferred files are not affected
  845.       by this parameter.
  846.  
  847.       Some networks may garble data when B+'s streaming causes ZCOMM to
  848.       respond to incoming data concurrently with incoming data.  The o
  849.       numeric parameter can be set to 0 to disable streaming (send-ahead).
  850.  
  851.       CompuServe B+ controls all file transfer operations (except permission
  852.       to overwrite files) from the timesharing system.
  853.  
  854.       Waiting for long files to download can be boring.  You can start the
  855.       transfer and walk away from the computer, but CompuServe will stay
  856.       connected for 15 minute$ after the transfer is finished if you don't
  857.       come back when the download finishes.  This expense can be avoided by
  858.       typing ALT-Q once the protocol transfer has started.  ALT-Q tells
  859.       ZCOMM to disconnect as soon as the protocol transfer is completed,
  860.       stopping the connect charges.  An alternative method is to control the
  861.       transfers with a script, using either ejryam or the less sophisticated
  862.       cissig and dow.t scripts included with the software distribution.
  863.  
  864.       When "browsing" through CompuServe's software "downloading section"
  865.       libraries, the kcisdl.t script file and ZCOMM allow you to download a
  866.       file with a single keystroke: F3.  Installation instructions are
  867.       provided in that file.
  868.  
  869.       13.14  User Exit Processing
  870.  
  871.       The onclosetx and oncloserx string parameters provide a facility to
  872.       perform user defined file related functions ("user exits") immediately
  873.       after each file is closed, while the protocol is still active.  Wild
  874.       card filename expansionss are not allowed in this context.
  875.  
  876.       The oncloserx string parameter may be used to perform user commands or
  877.       call a script once for each file received with a file transfer
  878.       protocol.
  879.  
  880.       EXAMPLE: set oncloserx @crc %rname; obey "!%mv %rname /tmp"
  881.       When each file is received, the crc command calculates and displays a
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc              Chapter 13 Protocol File Transfers
  885.  
  886.  
  887.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                   76
  889.  
  890.       CRC for the file.
  891.  
  892.       Then the !% command calls the mv program to move the file just
  893.       received to the /tmp directory.  The "%" in the "!%" command causes
  894.       the rest of the command string to be processed for string
  895.       substitutions.
  896.  
  897.  
  898.       The onclosetx string parameter may be used to perform user commands or
  899.       call a script once for each file sent with a file transfer protocol.
  900.       Wild card file name expansions may not be used in onclosetx.
  901.  
  902.       EXAMPLE: The following causes each successfully sent file to be moved
  903.       to the /done directory.
  904.            set onclosetx
  905.       @if !d? obey "!%mv %rname /done"
  906.  
  907.  
  908.       SEE ALSO: rname, tname, drive, pwd string parameters, ?, d?  test
  909.       conditions
  910.  
  911.       User exits will cause protocol timeouts if their scripts take too long
  912.       to finish.  Since both Zcomm and the remote machine are still
  913.       executing file transfer protocols when user exits are called, user
  914.       exit scripts can not reference the serial port.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                    Chapter 13 Message Transfers
  944.  
  945.  
  946.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                   77
  948.  
  949.       14.  MESSAGE TRANSFERS
  950.  
  951.       14.1  Downloading Messages
  952.  
  953.       ZCOMM is flexible capturing output from other systems.  The trick is
  954.       to make the remote send the information without too much
  955.       embellishment.
  956.  
  957.       When downloading files without a file transfer protocol, set the
  958.       timesharing system to send tabs as tab characters without expanding
  959.       them to spaces.  Turn off fill characters.  These extra characters
  960.       waste time and money and ZCOMM doesn't need them.  ZCOMM's s and S
  961.       term options can be used to strip control characters and escape
  962.       sequences from the capture download.
  963.  
  964.       EXAMPLE: t -s file
  965.  
  966.  
  967.       If the remote system responds to XOFF and XON, E term option may be
  968.       enabled to allow Error Containment(TM) to reduce the number of
  969.       characters garbled by "line hits".
  970.  
  971.       EXAMPLE: t -E7e file1 uses Error Containment to download file1 from a
  972.       system using 7 bits even parity.  Error Containment works best when
  973.       even or odd parity is available.
  974.  
  975.  
  976.       SEE ALSO: E, j, S, s term options
  977.  
  978.       14.1.1  XON/XOFF  Files of arbitrary length may be transferred if the
  979.       remote supports flow control with the ASCII XOFF and XON control
  980.       characters.  Output from most timesharing services may be captured to
  981.       a file using this method.
  982.  
  983.       To download a file with XON/XOFF flow control: t file1
  984.  
  985.  
  986.       14.1.2  DC2/DC4 (^R/^T)  Some bulletin boards support file downloads
  987.       by issuing a DC2 to open a capture buffer, sending the file, and
  988.       terminating the capture with DC4.  ZCOMM does not support this
  989.       "protocol" directly.  The review t and b commands can be used to strip
  990.       excess characters from the circular buffer before writing the file to
  991.       disk.
  992.  
  993.       This "protocol" can be implemented with Turbodial(TM) script commands:
  994.  
  995.       EXAMPLE: pat 1c "\022" "@kill; create capture.fil"
  996.            pat 2c "\024" "close"
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                    Chapter 14 Message Transfers
  1003.  
  1004.  
  1005.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                   78
  1007.  
  1008.       14.1.3  Data Dump  Sometimes no flow control is available.  The fget *
  1009.       command allows ZCOMM to accept a continuous stream of data at a
  1010.       maximum data rate determined by the hardware and software environment.
  1011.       With a hard disk, excellent results have been obtained with a 4.77 mHz
  1012.       PC accepting graphics dumps at 9600 bps.
  1013.  
  1014.       EXAMPLE: fget file1
  1015.  
  1016.  
  1017.       At slower speeds or with a fast computer, the term function j option*
  1018.       may be used for nonstop file capture.
  1019.  
  1020.       EXAMPLE: t -j file1
  1021.  
  1022.  
  1023.       The fget command does not provide a progress display.  While this
  1024.       allows the fastest possible data capture (38400 bps on a suitable
  1025.       computer), sometimes there is no handy way to monitor the flow of
  1026.       data.
  1027.  
  1028.       The term function I (super-image) option may be used to capture a
  1029.       binary file, provided CRT emulation is disabled with a display dumb
  1030.       command or by enabling v option.
  1031.  
  1032.       EXAMPLE: display dumb; t -Ij file1
  1033.  
  1034.       The fax directory entry in PHONES2.T gives another example of how
  1035.       ZCOMM's data capture options may be used to capture binary data.
  1036.  
  1037.       14.2  Uploading Messages
  1038.  
  1039.       It is often possible to upload files using the f command with one or
  1040.       more term options (such as w or p, possibly in combination with t).
  1041.  
  1042.       Message uploads are more reliable if you keyboard enab flow before
  1043.       connecting through Telenet.  If using Tymnet, type ^R^X just before
  1044.       the host computer name to enable flow control with XOFF and XON.
  1045.       Check with your network's documentation for further details or updates
  1046.       to this information.
  1047.  
  1048.       It often helps to use "half duplex" ( h term option) with the computer
  1049.       echo disabled when uploading files to the computer.  This saves the
  1050.       computer from wasting precious time echoing characters.
  1051.  
  1052.       Another tactic is to avoid uncorrected message transfers during peak
  1053.       hours.  Telephone usage peaks during midday with a resulting increase
  1054.       in noise induced line hits.  Timesharing computers and communications
  1055.       networks are more likely to drop characters due to buffer overloading
  1056.       during high traffic periods as well.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                    Chapter 14 Message Transfers
  1062.  
  1063.  
  1064.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                   79
  1066.  
  1067.       14.2.1  Paced  Some systems accept characters only at a certain rate,
  1068.       a slow speed for each character and possibly a pause at the end of
  1069.       each line.  Depending on the particular system, data transfer may have
  1070.       to pause briefly at the end of the line,[1] or wait for a particular
  1071.       character to signify readiness to accept the next line.  There may be
  1072.       an additional delay after that[2] before the remote is able to accept
  1073.       more data.
  1074.  
  1075.       EXAMPLE: f -p file1 uploads file1 with a wait for the linefeed echo at
  1076.       the end of each transmitted line.
  1077.  
  1078.  
  1079.       EXAMPLE: pg63; f -p file1 Sets the prompt character to decimal 63
  1080.       ("?") and sends the file with a wait for "?" after each transmitted
  1081.       line.
  1082.  
  1083.       As with the fpute command, the remote system must be commanded to open
  1084.       and close the file.
  1085.  
  1086.       14.2.2  Throttle  Another method of slowing message uploads is the
  1087.       throttle, activated by t term option.  Throttle artificially slows
  1088.       Zcomm's character transmission to allow more time for the receiving
  1089.       system to digest each character. The speed of transmission with t term
  1090.       option is controlled by the t numeric parameter.
  1091.  
  1092.       EXAMPLE: f -t secret.msg
  1093.  
  1094.       Really slow systems may require both throttle and pacing to send data
  1095.       efficiently without loss.
  1096.  
  1097.       EXAMPLE: f -tp turkey.slo
  1098.  
  1099.  
  1100.       14.2.3  Uploading to IBM Mainframes  Text files can be uploaded to IBM
  1101.       mainframes using the P (upper case) term option.  When the P term
  1102.       option is activated, ZCOMM will wait for an XON (^Q) after sending
  1103.       each line.  With this special option, the term function will not time
  1104.       out waiting for the XON, no matter how long it takes for the IBM front
  1105.       end to send it.  If, for some reason, the front end fails to send the
  1106.       XON, (or if it is garbled in transmission), Ctrl-Q may be keyboarded.
  1107.  
  1108.       EXAMPLE: f -P file1
  1109.  
  1110.  
  1111.  
  1112.       __________
  1113.  
  1114.        1. Controlled by the p numeric parameter
  1115.  
  1116.        2. Controlled by the q numeric parameter
  1117.  
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                    Chapter 14 Message Transfers
  1121.  
  1122.  
  1123.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                   80
  1125.  
  1126.       SEE ALSO: P term option, Kermit protocol
  1127.  
  1128.       14.2.4  Uploading Messages to Bulletin Boards  The greatest file
  1129.       transfer challenge is to upload a file to a bulletin board message
  1130.       system running on a tiny microcomputer.  Bulletin board message
  1131.       systems have a rich variety of operating sequences and timing
  1132.       dependencies matched only by the proliferation of incompatible
  1133.       dialects of Basic and Pascal.
  1134.  
  1135.       Message upload from files to bulletin boards reduces connect time and
  1136.       $welling of the Phone Bill.  Unattended message transfer saves the
  1137.       user's time, especially if the board is difficult to access.
  1138.  
  1139.       The t, p and w term options and the g, p, t, and q numeric parameters
  1140.       allow disk files to be uploaded to such systems.
  1141.  
  1142.       The basic program cbbsck.bas may be used (perhaps with modifications)
  1143.       to check that a message file does not violate the restrictions of the
  1144.       message system being uploaded to.  A C version is also available.
  1145.  
  1146.       EXAMPLE: f -pt file1
  1147.  
  1148.  
  1149.       14.2.5  Uploading to CompuServe SIGS  A file may be uploaded to a
  1150.       CompuServe SIG (Special Interest Group) editor with p term option and
  1151.       the g numeric parameter set to colon.  When the file has been
  1152.       transferred, hit ENTER to send a blank line to terminate message
  1153.       entry.
  1154.  
  1155.       EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p FILE Is useful for
  1156.       uploading a prepared message to Compuserve's bulletin boards.  This
  1157.       setting for eolstr inserts a carriage return and period after each
  1158.       line to prevent the CompuServe software from reformatting the message.
  1159.  
  1160.  
  1161.       EXAMPLE: pp1000, pg58, and f -p FILE transmits FILE waiting for the
  1162.       prompt character ":" before sending each line after the first.
  1163.  
  1164.  
  1165.       An alternative is to set the SIG "FIL" option, which calls the EDIT
  1166.       editor.  The cisupl script file referenced by phones2.t uses the SIG
  1167.       "FIL" editor option.
  1168.  
  1169.       Compuserve nodes often drop characters when files are uploaded at full
  1170.       speed in full duplex.  This can be avoided by using h term option
  1171.       (local echo) and turning off Compuserve's echo.
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                    Chapter 14 Message Transfers
  1180.  
  1181.  
  1182.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                   81
  1184.  
  1185.       14.3  Fpute: Echoplex Uploads
  1186.  
  1187.       Text files can often be uploaded reasonably efficiently using the
  1188.       fpute command.* Fpute waits for an echo to each character sent to the
  1189.       remote.  Fpute provides modest throughput without loss of data for
  1190.       systems with terminal ports designed for keyboard data entry.  The
  1191.       maximum speed with fpute is limited to about 1/3 the normal character
  1192.       rate by echo delays.  There is no error correction with fpute, but
  1193.       character by character handshaking prevents lost data caused by buffer
  1194.       overflow.  If possible, TABS should be set to echo as TAB characters
  1195.       and not as spaces.  Before the fpute command is given, the remote
  1196.       system must be instructed to enter data from the "terminal" to a file.
  1197.       After the file has been sent, the remote system must be instructed to
  1198.       close the file.
  1199.  
  1200.       EXAMPLE: fpute file1
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                         Chapter 14 Flow Control
  1239.  
  1240.  
  1241.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                   82
  1243.  
  1244.       15.  FLOW CONTROL
  1245.  
  1246.       All of us must sometimes tell people to "slow down" lest they overload
  1247.       us with information faster than we can write it down.  "Wait!" is a
  1248.       Flow Control Signal for the English language.  When the receiving
  1249.       ZCOMM complains about Garbled Data Subpacket or Line Status Register
  1250.       01 you should suspect a flow control problem.
  1251.  
  1252.       When buffered modems, timesharing systems, networks, or computers of
  1253.       differing speeds are involved, a machine readable "Wait!" signal is
  1254.       required.
  1255.  
  1256.       Flow control is sometimes necessary to display long messages without
  1257.       skipping over the good parts.  If you see pieces of text missing from
  1258.       messages but don't see the usual funny characters caused by line
  1259.       noise, you have a flow control problem.
  1260.  
  1261.       File transfers that use long blocks or streaming protocols may not
  1262.       work well unless slower parts of the system regulate the speed of
  1263.       transmission to prevent loss of data.  With ZMODEM, SuperKermit, and
  1264.       other streaming protocols, inexplicable retransmissions of data
  1265.       blocks, often at regular intervals, indicate flow control failure.
  1266.  
  1267.       If you wish to keep things simple, the sending computer should not
  1268.       operate at a higher interface speed than the slowest link in the
  1269.       network.  Otherwise precautions must be taken to prevent data loss
  1270.       with interactive operations and unnecessary retransmissions with
  1271.       streaming file transfer protocols.
  1272.  
  1273.       ZCOMM, ZCOMM, and DSZ default to software flow control with XON and
  1274.       XOFF characters.[1] When used with modems that require hardware flow
  1275.       control, the handshake command (q.v.) should be used to specify which
  1276.       hardware lines are to be used for flow control.
  1277.  
  1278.       Non transparent software flow control is incompatible with Emacs
  1279.       editors, XMODEM and YMODEM transfers.  XMODEM and YMODEM require
  1280.       complete transparency to all 256 8 bit codes.  An XMODEM transfer that
  1281.       always fails at the same block results from non transparent flow
  1282.       control.  When XMODEM-1k and YMODEM-1k are used, the network must
  1283.       assert flow control, or handle bursts of 1040 characters without data
  1284.       loss.  When X.25 or hardware CTS is unavailable, flow control that
  1285.       does not "eat" any characters may be used with XMODEM and YMODEM.
  1286.       When buffers fill up, an XOFF should be emitted.  An XON should be
  1287.  
  1288.  
  1289.       __________
  1290.  
  1291.        1. The PCDOS flavor enables "handshake both" when selecting a port
  1292.           with an active Clear To Send (CTS) signal that was previously
  1293.           initialized to a speed greater than 2400 bps
  1294.  
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                         Chapter 15 Flow Control
  1298.  
  1299.  
  1300.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                   83
  1302.  
  1303.       sent when the buffer has emptied.  Otherwise, the network should
  1304.       neither generate nor eat XON or XOFF characters.
  1305.  
  1306.       On Telenet, this is obtained by setting CCIT X3 5:1 and 12:1 in the
  1307.       PADs (Packet Assembler Disassembler) at both ends of the network.
  1308.       Packets should be forwarded when the packet is a full 128 bytes, or
  1309.       after a moderate delay (3:0,4:10).  Set parameter 5 to 1 at both ends
  1310.       AFTER one is connected to the remote modem.  (Sorry, these commands
  1311.       must be given each time you connect to a modem in the far city!)
  1312.            <ENTER>@<ENTER>
  1313.            set 5:1<ENTER>
  1314.            rst? 5:1<ENTER>
  1315.            cont<ENTER>
  1316.       ZMODEM and Kermit protect all 4 XOFF and XON characters, commonly used
  1317.       network control characters and trigger strings.  ZMODEM and Kermit are
  1318.       compatible with many networks that do not support XMODEM family
  1319.       protocols, including some that claim network compatibility.  For PADs
  1320.       that do not accept "rst?", use:
  1321.            <ENTER>@<ENTER>
  1322.            set 4:2,5:1,12:1<ENTER>
  1323.            cont<ENTER>
  1324.       For best Telenet download throughput, parameter 64 (advance ACK)
  1325.       should be set to 7.  The parameter 0 is a dummy argument that
  1326.       distinguishes Telenet parameters from CCIT parameters.
  1327.            <ENTER>@<ENTER>
  1328.            set 0:0,64:7<ENTER>
  1329.            cont<ENTER>
  1330.       Sometimes Telenet flow control stops data transmission when the
  1331.       network buffers are not yet full.  If you often see "STOPPED" flashing
  1332.       in the status line (DOS versions), or if you see the modem send data
  1333.       light pause in a ZMODEM or SuperKermit file send, poor flow control
  1334.       may be the culprit.  Such slowdowns are typical when a network is
  1335.       overloaded.  If this condition persists, the network should take steps
  1336.       to reduce the congestion.  Turning OFF network flow control and
  1337.       activating ZMODEM's or SuperKermit's protocol flow control may
  1338.       increase throughput under these conditions.
  1339.  
  1340.       Instead of or in addition to XON/XOFF flow control, the sending
  1341.       program's ZMODEM w numeric parameter can restrict the window size to a
  1342.       value that does not overload the network.  A zmodem pw2048 command
  1343.       restricts the window size (maximum number of bytes in transit) to
  1344.       2048.  This causes the sz command to trigger the receiver's
  1345.       acknowledgement every 512 bytes (one fourth the value of the ZMODEM w
  1346.       numeric parameter).  The sender monitors these responses and suspends
  1347.       transmission when necessary to restrict the window to the specified
  1348.       size.  Until a network dependent lower limit is reached, lower window
  1349.       sizes improve the speed of error recovery at the expense of slight
  1350.       increases in protocol overhead.  When the window size becomes less
  1351.       than the number of characters sent within the network's transit time,
  1352.       throughput falls off rapidly.  Frequent protocol acknowledgements slow
  1353.       down high speed pseudo full duplex modems (US Robotics HST, Telebit
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                         Chapter 15 Flow Control
  1357.  
  1358.  
  1359.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                   84
  1361.  
  1362.       TrailBlazer) and should be avoided.
  1363.  
  1364.       ZMODEM-90(TM) allows the receiver to specify the window size with the
  1365.       -Wn option where n is the desired window size.
  1366.  
  1367.       EXAMPLE: set adlopts W8192  C> set DSZOPT=W8192  requests an 8192 byte
  1368.       window size.
  1369.  
  1370.  
  1371.       Some modems and networks can be configured to flush (discard the
  1372.       contents of) their buffers when a break signal is received.  If this
  1373.       is possible, error recovery with ZMODEM transfers may be speeded up by
  1374.       setting the ZMODEM b parameter to 1, which sends a break whenever the
  1375.       ZMODEM sending program gets a retransmission request.
  1376.                    Network and Flow Control (FC) Compatibility
  1377.  
  1378.       ______________________________________________________________________
  1379.       |    Network     | Interactive | XMODEM | WXMODEM | S-KERMIT | ZMODEM |
  1380.       |________________|_____________|________|_________|__________|________|
  1381.       |No Network      | YES         | YES    | YES     | YES      | YES    |
  1382.       |8 bit, no FC    | NO          | YES    | YES     | YES(1)   | YES(1) |
  1383.       |Transparent FC  | YES         | YES    | YES     | YES      | YES    |
  1384.       |Non Transparent | YES         | NO     | NO      | YES      | YES    |
  1385.       |7 bit           | YES         | NO     | NO      | YES      | YES(2) |
  1386.       |________________|_____________|________|_________|__________|________|
  1387.  
  1388.       (1) Window size must be restricted to avoid buffer overrun if the
  1389.       network cannot transfer data at full speed.
  1390.       (2) Requires ZMODEM-90(TM) 7-bit support
  1391.  
  1392.       15.1  Got ZRPOS Errors
  1393.  
  1394.       Got ZRPOS indicates the receiving program has detected a transmission
  1395.       error and has requested retransmission.  In other words, ZMODEM is
  1396.       doing its job of detecting and correcting missing and garbled data.
  1397.  
  1398.       If this happens with error correcting modems, or more often than
  1399.       observed line noise would suggest, the receiver's error messages must
  1400.       be studied.  "Line Status Register 01" messages indicate a flow
  1401.       control problem.  "Line Status Register 02" messages suggest a
  1402.       receiver problem with interrupt latency.
  1403.  
  1404.       Otherwise, the sender may have a flow control problem in one of four
  1405.       areas:
  1406.  
  1407.         + Between the sending program and its modem.  If using an interface
  1408.           speed higher than the transmission speed, or modem to modem error
  1409.           correction (MNP, LAPB, PEP, etc.), check that the modem and the
  1410.           sending program are configured for the same flow control methods.
  1411.           Omen Technology's software is faster than most other programs, and
  1412.           may expose flow control problems not seen with slower software.
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                         Chapter 15 Flow Control
  1416.  
  1417.  
  1418.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                   85
  1420.  
  1421.         + Between the sending modem and the network.  Correcting this
  1422.           requires "handshake both" to allow the sending program to honor
  1423.           both hardware (CTS) flow control from the modem and software flow
  1424.           control (XON/XOFF) from the network.
  1425.  
  1426.         + Between parts of the network, or between the host computer and its
  1427.           terminal server(s).  We have received a number of reports of
  1428.           problems with Cisco terminal servers.
  1429.  
  1430.         + Between the receiving modem and the receiving program.  This can
  1431.           happen at high transmission speeds when the receiver has specified
  1432.           a large I/O buffer size with the B numeric parameter.
  1433.  
  1434.           Excessive interrupt latency from extended memory ramdisks or disk
  1435.           caches, and poorly written hard disk drivers also wreak havoc on
  1436.           streaming protocols but do not affect start-stop protocols
  1437.           (XMODEM, etc.).  Problems with extended memory disk caches may
  1438.           cause errors at regular intervals; check the receiver's error
  1439.           messages.
  1440.  
  1441.           To work around these problems, give the "handshake slow" command
  1442.           to the receiver.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                       Chapter 15 Running ZCOMM
  1475.  
  1476.  
  1477.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                   86
  1479.  
  1480.       16.  RUNNING ZCOMM
  1481.  
  1482.       Before running ZCOMM, the keyboard Caps Lock should be turned off.
  1483.       ZCOMM commands and most arguments must be entered in lower case.
  1484.  
  1485.  
  1486.       16.1  Running ZCOMM from DOS
  1487.  
  1488.       ZCOMM is called from DOS as ZCOMM [DPORT=n] [command ...]
  1489.  
  1490.       The following special commands may be given from the command line
  1491.       only.
  1492.  
  1493.       DPORT=n is an optional override to the default comm port.  If another
  1494.               program is using the default comm port, ZCOMM may be told to
  1495.               use another port to prevent interference.
  1496.  
  1497.               SEE ALSO: DPORT environment variable
  1498.  
  1499.       Command may be any desired combination of ZCOMM commands.  Command
  1500.       line arguments to ZCOMM must be in lower case except as noted.
  1501.  
  1502.       EXAMPLE: C>ZCOMM call cissig invokes ZCOMM and executes the commands
  1503.       in the "cissig" telephone directory entry.
  1504.  
  1505.  
  1506.       EXAMPLE: C>ZCOMM DPORT=2 call othersys
  1507.       Selects COM2 before initializing the serial port
  1508.  
  1509.  
  1510.  
  1511.       16.1.1  DOS Environment Variables  DOS environment variables are set
  1512.       with the DOS set command in the form SET VARIABLE=VALUE given in a
  1513.       batch file or at the DOS prompt.
  1514.  
  1515.       NOTE: There must not be any spaces before or after the "=" sign.  If
  1516.       you set many environment variables, DOS will quietly forget some of
  1517.       them unless you tell DOS to make more room for them.  You can issue
  1518.       the DOS "set" command by itself to check the accuracy of DOS
  1519.       environment variables.
  1520.  
  1521.       ZCOMM searches the DOS Environment for the following variables:
  1522.  
  1523.       CBSIZE overrides the default allocation for the circular buffer.** If
  1524.             memory is limited, the DOS command SET CBSIZE=3000 will leave
  1525.             more memory for DOS Gateway or other programs.  CBSIZE may be
  1526.             set as high as 65500.
  1527.  
  1528.             EXAMPLE: C>SET CBSIZE=65000
  1529.  
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1534.  
  1535.  
  1536.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                   87
  1538.  
  1539.       COMSPEC ZCOMM uses the DOS COMSPEC environment variable to load
  1540.             COMMAND.COM or similar program to parse and execute DOS gateways
  1541.             (shell escapes).  Normally DOS sets this variable for you.
  1542.  
  1543.       DIRRX, DIRSX, DIRCX, DIRPX, DIRFX Contain optional receive (DIRRX),
  1544.             send (DIRSX), capture (DIRCX), paste (DIRPX), and file (DIRFX)
  1545.             directory presets.  When ZCOMM starts, these environment
  1546.             variables preset the dirrx, dirsx, dircx, dirpx and dirfx string
  1547.             variables respectively.[1]
  1548.  
  1549.       DIRSIZE controls the number of directory items that may be sorted with
  1550.             each wildcard.  It should be set to 23 * times the desired
  1551.             number of entries (default = 200).  If more directory entries
  1552.             are encountered, they are processed without sorting.
  1553.  
  1554.             EXAMPLE: C>set DIRSIZE=8000
  1555.  
  1556.  
  1557.       DPORT overrides the default modem port (COM1) initially accessed by
  1558.             ZCOMM.
  1559.  
  1560.             EXAMPLE: C>set DPORT=2
  1561.  
  1562.             The DPORT environment variable can also be specified as a hex
  1563.             port address,vector number pair.
  1564.  
  1565.             EXAMPLE: C>set DPORT=2f8,5
  1566.  
  1567.  
  1568.             SEE ALSO: portx command
  1569.  
  1570.       EGA   Stting this to MONO causes ZCOMM to use video mode 7 for 80x25
  1571.             column text instead of the default video mode 3.  This is needed
  1572.             only when using some EGA cards with an Monochrome MDA compatible
  1573.             monitor.
  1574.  
  1575.             EXAMPLE: C>set EGA=MONO
  1576.  
  1577.  
  1578.       HOTPORT Suppresses the "Warning: Old dport=" message (q.v.) seen when
  1579.             Zcomm is called from certain operating systems or programs.
  1580.  
  1581.             EXAMPLE: C>set HOTPORT=1
  1582.  
  1583.  
  1584.  
  1585.  
  1586.       __________
  1587.  
  1588.        1. Or, these may be set in your phones.t or phones.ts file.
  1589.  
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1593.  
  1594.  
  1595.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                   88
  1597.  
  1598.             SEE ALSO: port, portx commands
  1599.  
  1600.       MODEM Selects the dialer script file appropriate to your modem.  This
  1601.             may also be set in your phones.t or phones.ts file.  See Chapter
  1602.             8 for details.
  1603.  
  1604.             EXAMPLE: C>set MODEM=mm224e.t
  1605.  
  1606.  
  1607.       PATH  must include the directories containing ZCOMM and the help
  1608.             processor YHP.
  1609.  
  1610.       PHONES overrides the default pathname used to fetch ZCOMM's telephone
  1611.             directory.  Forward slashes should be used to indicate
  1612.             directories.
  1613.  
  1614.             EXAMPLE: C>set PHONES=c:/yam/phones.t
  1615.  
  1616.  
  1617.       YAMQUIET Inhibits the display and locks the keyboard, preventing ZCOMM
  1618.             from writing on the screen. * This is useful when calling ZCOMM
  1619.             from another program.
  1620.  
  1621.             EXAMPLE: C>set YAMQUIET=257 Performs the equivalent of an
  1622.             initial kbdlock 257 command.
  1623.  
  1624.  
  1625.             SEE ALSO: kbdlock command
  1626.  
  1627.       ZONE  sets the z numeric parameter to the number of minutes the
  1628.             current local time lags GMT time.
  1629.  
  1630.             EXAMPLE: C>set ZONE=420
  1631.  
  1632.  
  1633.             SEE ALSO: z numeric parameter
  1634.       This may also be set in your phones.t or phones.ts file.
  1635.  
  1636.       Before running the X.PC* version of Pro-YAM, you must run the Tymnet
  1637.       X.PC driver to make it resident by calling the driver from DOS.  The
  1638.       driver announces itself and returns control to DOS.  The Tymnet X.PC
  1639.       driver uses approximately 40kb memory.
  1640.  
  1641.       EXAMPLE: xpcmain
  1642.  
  1643.  
  1644.  
  1645.       16.1.2  Help Processor Environment Variables  The flash-up help
  1646.       processor program YHP examines the environment for the NORMATTR,
  1647.       REVATTR, and UNDLATTR variables.  These set help screen parameters for
  1648.       normal, reverse video, and underline attributes corresponding to the
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1652.  
  1653.  
  1654.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                   89
  1656.  
  1657.       n,r, and u numeric parameters.
  1658.  
  1659.       EXAMPLE: C>set NORMATTR=3
  1660.  
  1661.  
  1662.  
  1663.       16.2  Dialing out from Unix
  1664.  
  1665.       ZCOMM is called from Unix as [DPORT=S] yam [command ...]
  1666.       DPORT=S is an optional override to the initial default serial line.
  1667.  
  1668.       If another program is using the line, ZCOMM complains that the port is
  1669.       busy and will refuse to open it.
  1670.  
  1671.       Command may be any desired combination of ZCOMM commands.
  1672.  
  1673.       EXAMPLE: yam call cissig invokes ZCOMM and executes the commands in
  1674.       the "cissig" telephone directory entry.
  1675.  
  1676.  
  1677.       EXAMPLE: DPORT=tty77 yam call othersys
  1678.       Selects /dev/tty77 before executing the othersys telephone directory
  1679.       entry.
  1680.  
  1681.  
  1682.       If ZCOMM is run in the background, it will exit if it reaches the main
  1683.       command prompt.
  1684.  
  1685.       EXAMPLE: yam call cissig&
  1686.  
  1687.  
  1688.       As a form of shorthand, ZCOMM may be invoked as call if that is the
  1689.       command to be executed.
  1690.  
  1691.       EXAMPLE: call cissig
  1692.  
  1693.  
  1694.  
  1695.       16.2.1  X Windows  When run under the X Windows xterm(1) interface
  1696.       program (indicated by the Unix TERM environment variable), ZCOMM
  1697.       understands xterm's keyboard mappings for function and ALT keys.
  1698.  
  1699.  
  1700.       16.2.2  UNIX/XENIX Environment Variables  Unix/Xenix ZCOMM flavors
  1701.       search the Environment for the following variables:
  1702.  
  1703.       CBSIZE overrides the default allocation for the circular buffer.  On
  1704.             32 bit systems, the maximum CBSIZE is limited only by the
  1705.             operating system's process size limit.
  1706.  
  1707.             EXAMPLE: CBSIZE=300000; export CBSIZE
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1711.  
  1712.  
  1713.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                   90
  1715.  
  1716.       DIRRX, DIRSX, DIRCX, DIRPX, DIRFX Perform the same function as
  1717.             described for the DOS flavor above.  (Since Unix does not use
  1718.             colon (:) as a device specifier, Unix flavors do not treat
  1719.             colon(s) in pathnames in any special way.)
  1720.  
  1721.       DPORT overrides the default modem port initially accessed by ZCOMM.
  1722.  
  1723.             EXAMPLE: DPORT=tty12; export DPORT
  1724.  
  1725.  
  1726.       HZ    Indicates the number of kernel "clock ticks" per second.  This
  1727.             calibrates terminal function timeouts, protocol timeouts, and
  1728.             the sleep command.  The HZ environment variable must be set if
  1729.             the value used by your system is not 100 clock ticks per second.
  1730.  
  1731.       LOGFILE Specifies the pathname for the log file (default:
  1732.             /tmp/yamlog.tmp) created by the -v option when invoking ZCOMM as
  1733.             xyam, rz, sz, rb, sb, rx, or sx.
  1734.  
  1735.             SEE ALSO: v option
  1736.  
  1737.       MODEM Describes the type of modem used by the mm224 script.  See
  1738.             Chapter 8 for details.
  1739.  
  1740.             EXAMPLE: MODEM=MM224E; export MODEM
  1741.  
  1742.  
  1743.       PATH  must include the directories containing yam and the help
  1744.             processor yhp.
  1745.  
  1746.       PHONES overrides the default pathname used to fetch ZCOMM's telephone
  1747.             directory.
  1748.  
  1749.             EXAMPLE: PHONES=/usr/lib/local/localphone.t; export PHONES
  1750.  
  1751.  
  1752.       SHELL ZCOMM uses this environment variable to select the appropriate
  1753.             program for its shell escapes.
  1754.  
  1755.       TERM  If the TERM environment variable contains xterm, xterms or
  1756.             anything else beginning with xterm, ZCOMM assumes it is
  1757.             operating as a subprocess to the Xwindows xterm(1) program,
  1758.             enabling a term function status line if the X numeric parameter
  1759.             allows.
  1760.  
  1761.             SEE ALSO: X numeric parameter The LINES and COLUMNS environment
  1762.             variables preset the # and $ numeric parameters respectively.
  1763.             This assumption may be overridden by setting the X numeric
  1764.             parameter.
  1765.  
  1766.             If the TERM environment parameter contains the string 401
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1770.  
  1771.